home *** CD-ROM | disk | FTP | other *** search
/ Web Star/List Star - Eve…he Ultimate Internet Site / StarNine Internet Pubisher (Web Star and List Star)(StarNine)(1995).iso / ListSTAR™ / Tools and Enhancments / Enhancing ListSTAR Digests / Do Digests ReadMe v3.0.5 next >
Encoding:
Text File  |  1995-08-06  |  4.7 KB  |  74 lines  |  [TEXT/ttxt]

  1. Do Digests 3.0.5 for ListSTAR
  2.  
  3. The enclosed scripts will manage a full-featured digest system with HTML filing.  The scripts handle the generation of a Table of Contents for the digest file, sending the digest to the list, and saving the digest in HTML.
  4.  
  5.  This is a complicated script with many variables to customize.  Be sure to follow each step carefully.
  6.  
  7.  
  8. What you Need
  9.  
  10. •  AppleScript as well as the scriptable Finder.  (An install of System 7.5 or later guarantees compatibility, although System 7 Pro may work as well.)  
  11.  
  12. • Version 1.0 or later of both WebSTAR and ListSTAR. 
  13.  
  14. • Scripting Additions.
  15.    ACME Replace OSAX 
  16.    save/read data OSAX
  17.  
  18. These additions are located in the ListSTAR Scripting Tools folder.  ACME replace is in the ACME Script Widgets Demo 2 folder and save/read data is in the save/read 1.3 folder.
  19.  
  20. • Scripting Additions (Available via FTP)
  21.    JonsCommands 1.3.6
  22.    ftp://gaea.kgs.ukans.edu/applescript/osaxen/JonsCommands136.sit.hqx
  23.  
  24.    GTQ Scripting Library ("Date string for" addition)
  25.    ftp://gaea.kgs.ukans.edu/applescript/osaxen/gtqscriptlib1.2.sit.hqx
  26.  
  27. (NOTE: Some of these scripts are shareware.  You should pay the authors directly for use).
  28.  
  29.  
  30. Customizing the Scripts
  31.  
  32. It is suggested that you start from an unmodified copy of the "Listserver Demo" included with the standard install of ListSTAR.  This ReadMe is written from that perspective.
  33.  
  34. There are two scripts which need to be edited, "Send/File Digests v3.0.5" and "Make TOC v3.0.5".  Both of them are heavily commented and consist of varying properties to fill in.  The third script, "Make Digests v3.0.5", requires no modification.
  35.  
  36. Place the "Digests Data" folder in the newly created service folder (i.e. if you copy the "Listserver Demo" and name it "My Listserver",  put the "Digests Data" folder in the "My Listserver" folder found in the "Services" folder) along with the edited copies of "Send/File Digests v3.0.5" and "Make TOC v3.0.5".  Place an alias of the "Filed Digests" folder (which exists in the newly created service folder) within your WebSTAR folder.  The alias will be part of the URL path referenced in the "Send/File Digests v3.0.5" script.  
  37.  
  38. Place the "Make Digests v3.0.5" script library in the "AppleScripts" folder found in the main ListSTAR folder.
  39.  
  40.  
  41. Configuring ListSTAR
  42.  
  43. Configuring ListSTAR for this script involves creating two new rules and editing the "Reflect and File" rule found in the "Listserver Demo" duplicate.  
  44.  
  45. • Create a rule named "Detect Self Mailings" 
  46. Purpose: To detect mail that the service has sent to itself.
  47. 1) Select the Address Trigger Icon.  Choose "From <e-mail address> <starts with>" and fill in the e-mail address of the listserver.
  48. 2) Select the Miscellaneous Action Icon.  Check "Stop rule processing" and enter a meaningful log message such as "Self mail detected and discarded".
  49. 3) Move this rule to the top of the rule list (by clicking and dragging) so that it will be evaluated first.
  50.  
  51. • Create a rule entitled "File HTML Digests" 
  52. Purpose:  To execute the "Make TOC v3.0.5" script and file a copy of the digest body to be included in the final, archived digests.
  53. 1) Select the Content Trigger Icon.  Under the miscellaneous trigger heading select "Execute AppleScript" and choose the "Make TOC v3.0.5" script you modified earlier.
  54. 2) Select the Address Trigger Icon.  Check "From address <is in>" and use the list selector to choose both the digested address list and the main address list.
  55. 3) Select the Mailing-List Action Icon.  Check "Select a digest file" and choose the file "Test HTML Digest" from the "Digest Data" folder.  You must check "add body", but the other two items may be checked as well.
  56. 4) Move this rule above the rule "Reflect and File" rule (by clicking and dragging).
  57.  
  58. • Edit the "Reflect and File" rule.
  59. 1) Select the Mailing-List Action Icon.   Under the "Digest Actions" heading, change the "Select Digest File" action to point to the "Test Digest" file within the "Digest Data" folder.
  60.  
  61. • Now Make a copy of the "Listserver Demo Timer" service
  62.  
  63. • Create a rule called "Send MyService Digests".  
  64. 1) Select the Timing Icon.  Set it to execute once per day.
  65. 2) Select the Timing Icon.  Under the "Miscellaneous Trigger" heading select "File is greater than zero bytes".  Then select the file "Test Digest" from the "Digest Data" folder.
  66. 3) Select the Miscellaneous Action Icon.  Check "Execute AppleScript", then select the "Send/File Digests v3.0.5" script you modified above.  It's a good idea to include a meaningful log message as well.
  67.  
  68. • Disable the "Manage Digest Files" rule
  69.  
  70. If you have any problems or questions, contact StarNine Support <support@starnine.com>.  Unfortunately, we cannot support any further customization of this script.  See the ListSTAR Scripts ReadMe for more sources of information.
  71.  
  72.  
  73. ©1995 StarNine Technologies
  74.